home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 23 / AACD 23.iso / AACD / Programming / DragnDrop / doc / Dragndrop.doc
Text File  |  2001-06-11  |  25KB  |  954 lines
  1.  
  2. TABLE OF CONTENTS
  3.  
  4. dragndrop.library/ActivateScreen
  5. dragndrop.library/DND_CloseDrag
  6. dragndrop.library/DND_Draw
  7. dragndrop.library/DND_DrawPolygon
  8. dragndrop.library/DND_FreeData
  9. dragndrop.library/DND_FreeInfo
  10. dragndrop.library/DND_FreeResult
  11. dragndrop.library/DND_Get
  12. dragndrop.library/DND_GetData
  13. dragndrop.library/DND_Give
  14. dragndrop.library/DND_GiveResult
  15. dragndrop.library/DND_GiveData
  16. dragndrop.library/DND_Info
  17. dragndrop.library/DND_Isonline
  18. dragndrop.library/DND_Login
  19. dragndrop.library/DND_Logout
  20. dragndrop.library/DND_MoveDrag
  21. dragndrop.library/DND_OpenDrag
  22. dragndrop.library/DND_OpenPolygon
  23. dragndrop.library/DND_TestArea
  24. dragndrop.library/DND_TestPolygon
  25. dragndrop.library/DND_Whoisonline
  26. dragndrop.library/SetMousePos
  27. dragndrop.library/SetMousePosDelta
  28. dragndrop.library/DND_OpenDragWB
  29. dragndrop.library/DND_CheckforDataMsg
  30. dragndrop.library/DND_GetDataMsg
  31. dragndrop.library/DND_CheckForDataMsgFromID
  32. dragndrop.library/DND_GetDataMsgFromID
  33.  
  34. dragndrop.library/ActivateScreen               dragndrop.library/ActivateScreen
  35.  
  36.     NAME
  37.         ActivateScreen -- activates screen , brings it NOT to front
  38.  
  39.     SYNOPSIS
  40.  
  41.         ActivateScreen(Screen)
  42.                          A0
  43.             
  44.     FUNCTION
  45.  
  46.         This function activates the screen, so that a application can change
  47.         the inputscreen for the gui from one to another. Background of this is
  48.         to develop a two screen display.
  49.  
  50.     INPUTS
  51.         Screen - a vaild screen structure
  52.  
  53.  
  54.     RESULT
  55.         NONE
  56.  
  57.     BUGS 
  58.         NONE
  59.         
  60.     SEE ALSO
  61.         intuition.library/OpenScreen() , intuition.library/OpenScreenTagList() 
  62.  
  63. dragndrop.library/DND_CloseDrag                 dragndrop.library/DND_CloseDrag
  64.  
  65.     NAME
  66.         DND_CloseDrag -- Closes DragIcon on Screen
  67.  
  68.     SYNOPSIS
  69.         DND_CloseDrag(Drag)
  70.                       a0
  71.             
  72.         DND_CloseDrag(Struct Drag)
  73.  
  74.     FUNCTION
  75.         Removes dragicon from your screen and frees the dragstructure.
  76.  
  77.     INPUTS
  78.         Drag - Result of DND_Opendrag()
  79.  
  80.     RESULT
  81.         NONE
  82.  
  83.     BUGS 
  84.         NONE
  85.         
  86.     SEE ALSO
  87.         DND_OpenDrag() , DND_MoveDrag() 
  88.  
  89. dragndrop.library/DND_Draw                           dragndrop.library/DND_Draw
  90.  
  91.     NAME
  92.         DND_Draw -- Draws a given array of dragareas
  93.  
  94.     SYNOPSIS
  95.         DND_Draw(Rastport,Field,Pen)
  96.                     a0      a1   d0
  97.             
  98.         DND_Draw(Struct Rastport,Struct Dragarea,Pencolor)
  99.  
  100.     FUNCTION
  101.         Draws Dragborders of given array of dragareas into the given rastport
  102.         with the color defined with pen. 
  103.  
  104.         Use this function (only) to test your dragarray.
  105.  
  106.     INPUTS
  107.         Rastport - Rastport of your Window/Screen 
  108.         
  109.         Field    - Array of X-Y-Coordinates (from/to) (0,0)-Terminated
  110.  
  111.         Pen      - Pencolor to use while drawing
  112.  
  113.     RESULT
  114.         NONE
  115.  
  116.     BUGS 
  117.         NONE
  118.         
  119.     SEE ALSO
  120.         DND_DrawPolygon()
  121. dragndrop.library/DND_DrawPolygon             dragndrop.library/DND_DrawPolygon
  122.  
  123.     NAME
  124.         DND_DrawPolygon -- Draws a given dragpolygon
  125.  
  126.     SYNOPSIS
  127.         DND_DrawPolygon(Rastport,Field,Pen)
  128.                           a0      a1   d0
  129.             
  130.         DND_DrawPolygon(Struct Rastport,Struct DragPolygon,Pencolor)
  131.  
  132.     FUNCTION
  133.         Draws Dragborder of given dragpolygon into the given rastport
  134.         with the color defined with pen. 
  135.  
  136.         Use this function (only) to test your dragpolygon
  137.  
  138.     INPUTS
  139.         Rastport - Rastport of your Window/Screen 
  140.         
  141.         Field    - Array of X-Y-Coordinates (0,0)-Terminated
  142.  
  143.         Pen      - Pencolor to use while drawing
  144.  
  145.     RESULT
  146.         NONE
  147.  
  148.     BUGS 
  149.         NONE
  150.         
  151.     SEE ALSO
  152.         DND_Draw()
  153. dragndrop.library/DND_FreeData                   dragndrop.library/DND_FreeData
  154.  
  155.     NAME
  156.         DND_FreeData -- frees datastructure
  157.  
  158.     SYNOPSIS
  159.         DND_FreeData(Datastructure)
  160.                           a0      
  161.             
  162.         DND_FreeData(Struct Datastructure)
  163.  
  164.     FUNCTION
  165.         Frees memory used for Datastructure. You must free every datastructures
  166.         yourself. 
  167.  
  168.     INPUTS
  169.         Datastructure - Result of DND_GetData()
  170.  
  171.     RESULT
  172.         NONE
  173.  
  174.     BUGS 
  175.         NONE
  176.         
  177.     SEE ALSO
  178.         DND_GetData()
  179. dragndrop.library/DND_FreeInfo                   dragndrop.library/DND_FreeInfo
  180.  
  181.     NAME
  182.         DND_FreeInfo -- Frees Infostructure
  183.  
  184.     SYNOPSIS
  185.         DND_FreeInfo(InfoStructure)
  186.                           a0
  187.             
  188.         DND_FreeInfo(Struct InfoStructure)
  189.  
  190.     FUNCTION
  191.         Frees Infostructure returned by DND_Info()
  192.  
  193.     INPUTS
  194.         Infostructure - Result of DND_Info()
  195.  
  196.     RESULT
  197.         NONE
  198.  
  199.     * WARNING * DND_FreeInfo() and DND_Info() in version 1 do nothing and return
  200.     immediately.
  201.  
  202.     BUGS 
  203.         NONE
  204.         
  205.     SEE ALSO
  206.         DND_Info()
  207.  
  208. dragndrop.library/DND_FreeResult               dragndrop.library/DND_FreeResult
  209.  
  210.     NAME
  211.         DND_FreeResult -- Frees TA_Result and TP_Result
  212.  
  213.     SYNOPSIS
  214.         DND_FreeResult(T?_Result)
  215.                           a0
  216.             
  217.         DND_FreeResult(Struct T?_Result)
  218.  
  219.     FUNCTION
  220.     
  221.         Frees structures TA_Result and TP_Result.
  222.  
  223.     INPUTS
  224.  
  225.         T?_Result - Result of DND_TestArea() or DND_TestPolygon().
  226.  
  227.     RESULT
  228.         NONE
  229.  
  230.     BUGS 
  231.         NONE
  232.         
  233.     SEE ALSO
  234.         DND_TestArea() , DND_TestPolygon()
  235. dragndrop.library/DND_Get                             dragndrop.library/DND_Get
  236.  
  237.     NAME
  238.         DND_Get -- Gets information send by other tasks
  239.  
  240.     SYNOPSIS
  241.         ok = DND_Get(Task)
  242.         d0            d0            
  243.  
  244.         Long = DND_Get(Long Task)
  245.  
  246.     FUNCTION
  247.  
  248.         DND_Get() gets a message send by other tasks using DND-Library.
  249.         It searches the messagepipe for messages which have your tasknumber
  250.         as recipient. This message has information about the rastport and
  251.         coordinates the other TASK wants you to process. Think of a DragIcon
  252.         which jumps from one screen or application to another!
  253.  
  254.     INPUTS
  255.  
  256.         Task - Result of FindTask(0) 
  257.                Task will be used as a unique number. If you ask why you can`t
  258.                use ultility.library/GetUniqueID() as a unique number, it`s easy.
  259.                How will you know which number another tasks uses?
  260.                You can also use valid windows as ID`s like DirectDos does.
  261.  
  262.     RESULT
  263.         OK - returns -1 if function can`t find a message for Task or can`t
  264.                         allocate memory.
  265.              returns address of a TA_Result-Structure
  266.  
  267.              STRUCTURE TA_Resultstructure,0
  268.                 Long X
  269.                 Long Y
  270.                 Long X1
  271.                 Long Y1
  272.                 Long Rastport
  273.  
  274.     EXAMPLE
  275.     
  276.         SendMessage:
  277.                 TargetTask=FindTask("ASM-One")
  278.                 MyTask=Findtask(0)
  279.                 If (Result=DND_IsOnline(TargetTask))#0 {
  280.                         DND_Give(TargetTask,Rastport,X,Y,X1,Y1,MyTask)
  281.                                                        }
  282.                 ...
  283.  
  284.         GetMessage:
  285.                 MyTask=FindTask(0)
  286.                 While (Result=DND_Get(MyTask))#0 {
  287.                                                    Delay(1)
  288.                                                  }
  289.                 ...Process...
  290.                 DND_FreeResult(Result)
  291.                 ...
  292.  
  293.  
  294.     BUGS 
  295.         NONE
  296.         
  297.     SEE ALSO
  298.         DND_GetData()
  299.  
  300. dragndrop.library/DND_GetData                     dragndrop.library/DND_GetData
  301.  
  302.     NAME
  303.         DND_GetData -- Gets datastructure send from another task
  304.  
  305.     SYNOPSIS
  306.         OK = DND_GetData(Task)
  307.         d0                d0 
  308.             
  309.         Long = DND_GetData(Struct Task)
  310.  
  311.     FUNCTION
  312.         Gets datastructure from datamessagepipe if there`s a message to get.
  313.  
  314.     INPUTS
  315.         Task - see DND_Get()/INPUTS
  316.  
  317.     RESULT
  318.         ok - returns -1 for failure or
  319.              address of Datastructure:
  320.  
  321.              STRUCTURE Datastructure,0
  322.                 Long TargetTask
  323.                 Long SendTask
  324.                 Long Data
  325.                 APTR NextDatastructure ( Private! Don`t mess with that! )
  326.  
  327.     BUGS 
  328.         NONE
  329.         
  330.     SEE ALSO
  331. dragndrop.library/DND_Give                           dragndrop.library/DND_Give
  332.  
  333.     NAME
  334.         DND_Give -- Send Information to another Task
  335.  
  336.     SYNOPSIS
  337.         OK = DND_Give(TargetTask,Rastport, X , Y , X1 , Y1 ,MyTask)
  338.         d0              d0           a0   d1  d2   d3   d4     a1
  339.             
  340.       Long = DND_Give(Struct Task,Struct Rastport,Long X,Long Y,Long X1,
  341.                       Long Y1,Struct Task)
  342.  
  343.     FUNCTION
  344.         This function sends information about the dragarea to another task.
  345.  
  346.     INPUTS
  347.         Targettask - see DND_Get()/INPUTS
  348.  
  349.         Mytask     - see DND_Get()/INPUTS
  350.  
  351.         Rastport   - rastport where the icon is placed.
  352.  
  353.         X,Y,X1,Y1  - coordinates of the dragicon
  354.  
  355.     RESULT
  356.         ok - returns  0 if fails 
  357.              returns -1 if success
  358.  
  359.     BUGS 
  360.         NONE
  361.         
  362.     SEE ALSO
  363.         DND_Get(), DND_GiveResult()
  364. dragndrop.library/DND_GiveResult               dragndrop.library/DND_GiveResult
  365.  
  366.     NAME
  367.         DND_GiveResult - Sends T?_Resultstructure to another task
  368.  
  369.     SYNOPSIS
  370.        OK = DND_GiveResult(TargetTask,Rastport,T?_Result,MyTask)
  371.        d0                      d0        a0        a1     a2
  372.             
  373.      Long = DND_GiveResult(Struct Task,Struct Rastport,Struct T?_Result,
  374.                            Struct Task)
  375.  
  376.     FUNCTION
  377.         GiveResult() sends a copy of T?_Result to the given Task.
  378.  
  379.     INPUTS
  380.         Targettask - see DND_Get()/INPUTS
  381.  
  382.         Mytask     - see DND_Get()/INPUTS
  383.  
  384.         Rastport   - rastport where the icon is placed.
  385.         
  386.         T?_Result  - address of TA_Result or TP_Result
  387.  
  388.     RESULT
  389.         Ok - returns  0 if fails 
  390.              returns -1 if success
  391.  
  392.     BUGS 
  393.         NONE
  394.         
  395.     SEE ALSO
  396.         DND_TestArea(),DND_TestPolygon(),DND_Give(),DND_GiveData(),DND_Get()
  397.  
  398. dragndrop.library/DND_GiveData                   dragndrop.library/DND_GiveData
  399.  
  400.     NAME
  401.         DND_GiveData -- Sends data to another task
  402.  
  403.     SYNOPSIS
  404.         OK = DND_GiveData(TargetTask,Mytask,Data)
  405.                              a0        a1    a2
  406.             
  407.       Long = DND_GiveData(Struct task,Struct task,Long Data)
  408.        
  409.     FUNCTION
  410.         GiveData() send a Datastructure to given task.      
  411.  
  412.     INPUTS
  413.         Targettask - see DND_Get()/INPUTS
  414.  
  415.         Mytask     - see DND_Get()/INPUTS
  416.     
  417.                      or Null
  418.                      
  419.         Data:
  420.     
  421.         if MyTask is zero data is a pointer to a special taglike list. First
  422.         element *MUST* be MYTASK! All following elements are not defined yet!
  423.     
  424.         See "www.geocities.com/SiliconValley/Bridge/5737/Main/Preass.html"
  425.         for more information.
  426.             
  427.  
  428.     RESULT
  429.         Ok - returns  0 if fails 
  430.              returns -1 if success
  431.  
  432.     BUGS 
  433.         NONE
  434.         
  435.     SEE ALSO
  436.         DND_TestArea(),DND_TestPolygon(),DND_Give(),DND_GiveResult(),DND_Get()
  437.  
  438. dragndrop.library/DND_Info                           dragndrop.library/DND_Info
  439.  
  440.     NAME
  441.         DND_Info -- gets infos about dragndrop.library
  442.  
  443.     SYNOPSIS
  444.         Result=DND_Info()
  445.             
  446.     FUNCTION
  447.         In a later version, dragndrop.library will send you informations about
  448.         the library like version,revision,logins,functions and prefs.
  449.  
  450.     INPUTS
  451.         NONE
  452.  
  453.     RESULT
  454.         returns actual -1
  455.  
  456.     BUGS 
  457.         NONE
  458.         
  459.     SEE ALSO
  460.         DND_FreeInfo()
  461.  
  462. dragndrop.library/DND_IsOnline                   dragndrop.library/DND_IsOnline
  463.  
  464.     NAME
  465.         DND_IsOnline() -- asks library if task has logged in
  466.  
  467.     SYNOPSIS
  468.         Result = DND_Isonline(Task)
  469.           d0                   d0
  470.             
  471.           Long = DND_IsOnline(struct Task)
  472.  
  473.     FUNCTION
  474.         Checks if a given task has logged in.
  475.  
  476.     INPUTS
  477.         Task   - see DND_Get()/INPUTS
  478.  
  479.     RESULT
  480.         Result - returns   0  if it fails to find task
  481.                  returns Task if it finds the task
  482.  
  483.     BUGS 
  484.         NONE
  485.         
  486.     SEE ALSO
  487.         DND_WhoIsOnline(), DND_Login(), DND_Logout()
  488.  
  489. dragndrop.library/DND_Login                         dragndrop.library/DND_Login
  490.  
  491.     NAME
  492.         DND_Login -- logs task into database
  493.  
  494.     SYNOPSIS
  495.         OK = DND_Login(Task)
  496.         d0              d0
  497.             
  498.       long = DND_Login(Struct Task)
  499.  
  500.     FUNCTION
  501.         Tries to log your task into the internal database.
  502.  
  503.     INPUTS
  504.         Task - see DND_Get()/INPUTS
  505.  
  506.     RESULT
  507.         ok - return -1   if database is full
  508.              return  0   if another task has already logged in with your 
  509.                             taskstructure
  510.              return TASK if logged in.
  511.     BUGS 
  512.         NONE
  513.         
  514.     SEE ALSO
  515.         DND_Logout(), DND_Whoisonline(), DND_IsOnline()
  516.  
  517. dragndrop.library/DND_Logout()                   dragndrop.library/DND_Logout()
  518.  
  519.     NAME
  520.         DND_Logout -- loggs your task out
  521.  
  522.     SYNOPSIS
  523.         OK = DND_Logout(Task)
  524.         d0               d0
  525.             
  526.       Long = DND_Logout(struct Task)
  527.  
  528.     FUNCTION
  529.         Loogs you task out of internal database. Other tasks can`t find you 
  530.         anymore.
  531.  
  532.     INPUTS
  533.         Task - see DND_Get()/INPUTS
  534.  
  535.     RESULT
  536.         ok - return -1   if databaseend is hit while searching your Task
  537.              return  0   if your task can`t be found
  538.              return TASK if logged out.
  539.  
  540.     BUGS 
  541.         NONE
  542.         
  543.     SEE ALSO
  544.         DND_Login(), DND_Whoisonline(), DND_IsOnline()
  545.  
  546. dragndrop.library/DND_MoveDrag                   dragndrop.library/DND_MoveDrag
  547.  
  548.     NAME
  549.         DND_MoveDrag -- Moves your dragicon
  550.  
  551.     SYNOPSIS
  552.         DND_MoveDrag(Drag,DeltaX,DeltaY)
  553.             
  554.         DND_MoveDrag(Struct Drag,Long ,Long )
  555.  
  556.     FUNCTION
  557.         Moves your dragicon around.
  558.  
  559.     INPUTS
  560.         Drag   - Result of DND_OpenDrag()
  561.  
  562.         DeltaX - how far to move the Window on the x-axis
  563.         DeltaY - how far to move the Window on the y-axis
  564.  
  565.     RESULT
  566.         NONE
  567.  
  568.     BUGS 
  569.         NONE
  570.         
  571.     SEE ALSO
  572.         DND_OpenDrag(), DND_CloseDrag()
  573. dragndrop.library/DND_OpenDrag                   dragndrop.library/DND_OpenDrag
  574.  
  575.     NAME
  576.         DND_OpenDrag -- Opens a dragicon on the given screen
  577.  
  578.     SYNOPSIS
  579.         Drag = DND_OpenDrag(Rastport,TA_Result,Screen)
  580.          d0                    a0       a1       a2
  581.             
  582.         Long = DND_OpenDrag(Sruct Rastport,struct TA_Result,Struct Screen)
  583.  
  584.     FUNCTION
  585.         This function opens a dragicon on your screen. It copies the graphic
  586.         from your rastport to the dragicon. You must use the TA_Resultstructure
  587.         to tell the function which region you want as a dragicon. 
  588.  
  589.     WARNING 
  590.  
  591.         In later versions of DND you could offer a own graphic for this
  592.         operation. So DON`T create a TA_RESULT on your own!
  593.  
  594.     INPUTS
  595.  
  596.         Rastport  - rastport where to find the graphics
  597.         TA_RESULT - result of DND_TestArea()
  598.         Screen    - screen on which you want to place the new dragicon
  599.  
  600.         "You could open a dragicon on someoneothers screen!?! Why ???"
  601.  
  602.         "Think of an application with two screens !!!( maybe AGA and CGX )"
  603.  
  604.     RESULT
  605.         Drag - Dragstructure ( no usefull data for you )
  606.  
  607.     BUGS 
  608.         NONE
  609.         
  610.     SEE ALSO
  611.         DND_CloseDrag(), DND_MoveDrag(), DND_Openpolygon()
  612.  
  613. dragndrop.library/DND_OpenPolygon             dragndrop.library/DND_OpenPolygon
  614.  
  615.     NAME
  616.         DND_Openpolygon -- opens a given polygon as dragicon
  617.  
  618.     SYNOPSIS
  619.         Drag = DND_Openpolygon(Rastport,TP_result,Screen)
  620.             
  621.         see DND_OpenDrag()
  622.  
  623.     FUNCTION
  624.  
  625.         Opens a Polygon as Dragicon --> DND_OpenDrag
  626.  
  627.     INPUTS
  628.         see DND_OpenDrag
  629.  
  630.     RESULT
  631.         NONE
  632.  
  633.     BUGS 
  634.         NONE
  635.         
  636.     SEE ALSO
  637.         DND_OpenDrag(), DND_CloseDrag() ,DND_MoveDrag()
  638.  
  639. dragndrop.library/DND_TestArea                   dragndrop.library/DND_TestArea
  640.  
  641.     NAME
  642.         DND_TestArea  -- tests if a mouseclick hits a drag/dropicon
  643.  
  644.     SYNOPSIS
  645.         TA_Result = DND_TestArea(Field,Mx,My)
  646.             d0                     a0  d0 d1
  647.  
  648.         Long = DND_TestArea(Struct Dragarea, Long, Long)
  649.  
  650.     FUNCTION
  651.         This function checks if a mouseclick is inside of one dragicon of the
  652.         given dragarea. You can use a droparea ( similiar to dragarea ) instead!
  653.  
  654.     INPUTS
  655.         Dragarea - see DND_CreateDrag()
  656.         Mx  - X-mousepos found in the intuimessage
  657.         My  - Y-mousepos found in the intuimessage
  658.  
  659.     RESULT
  660.         TA_Result - returns 0 if not inside of one dragicon
  661.                     returns TA_Resultstructure if it`s a hit 
  662.  
  663.     BUGS 
  664.         NONE
  665.         
  666.     SEE ALSO
  667.         DND_TestPolygon(), DND_CreateDrag 
  668.  
  669. dragndrop.library/DND_TestPolygon             dragndrop.library/DND_TestPolygon
  670.  
  671.     NAME
  672.         DND_TestPolygon  -- tests if a mouseclick hits a Polygon
  673.  
  674.     SYNOPSIS
  675.         TP_Result = DND_TestPolygon(Polygon,Mx,My)
  676.             d0                        a0    d0 d1
  677.  
  678.         Long = DND_TestPolygon(Struct Polygon, Long, Long)
  679.  
  680.     FUNCTION
  681.         This function checks if a mouseclick is inside of a given Polygon.
  682.  
  683.     INPUTS
  684.         Polygon - see DND_CreatePolygon()
  685.         Mx  - X-mousepos found in the intuimessage
  686.         My  - Y-mousepos found in the intuimessage
  687.  
  688.     RESULT
  689.         TP_Result - returns 0 if not inside of the polygon
  690.                     returns TP_Resultstructure if it`s a hit 
  691.  
  692.     BUGS 
  693.         NONE
  694.         
  695.     SEE ALSO
  696.         DND_TestArea(), DND_CreatePolygon 
  697.  
  698. dragndrop.library/DND_Whoisonline             dragndrop.library/DND_Whoisonline
  699.  
  700.     NAME
  701.         DND_WhoIsOnline -- Copies actual internal database
  702.  
  703.     SYNOPSIS
  704.         OK = DND_WhoIsOnline(Buffer, MaxChars)
  705.             
  706.       Long = DND_WhoIsOnline(char Buffer, Long)
  707.  
  708.     FUNCTION
  709.         copies as much as possible data from the internal database to
  710.         your buffer , so you can access it. Your buffer will be filled with
  711.         all tasks logged in or as much as possible.
  712.  
  713.     INPUTS
  714.         buffer   - pointer to a free memoryblock
  715.         maxchars - lenght of buffer   
  716.     
  717.     RESULT
  718.         ok - returns  0 if your buffer runs out of space 
  719.              returns -1 if ok
  720.  
  721.     BUGS 
  722.         NONE
  723.         
  724.     SEE ALSO
  725.         DND_IsOnline(), DND_Login(), DND_Logout()
  726.  
  727. dragndrop.library/SetMousePos                     dragndrop.library/SetMousePos
  728.  
  729.     NAME
  730.         SetMousePos -- Sets Mouseposition into screen and window
  731.         
  732.     SYNOPSIS
  733.  
  734.         SetMousePos(Screen,Window,MouseX,MouseY)
  735.                       A1     A0     D0     D1
  736.             
  737.     FUNCTION
  738.         Set MouseX and MouseY into intuitionbase, screenstructure and 
  739.         windowstructure.
  740.     
  741.     INPUTS
  742.  
  743.         Screen - screen structure for window
  744.         Window - window structure for screen
  745.         MouseX - Mouse Pos X
  746.         MouseY - Mouse Pos Y
  747.         
  748.     RESULT
  749.         NONE
  750.  
  751.     BUGS 
  752.         NONE
  753.         
  754.     SEE ALSO
  755. dragndrop.library/SetMousePosDelta           dragndrop.library/SetMousePosDelta
  756.  
  757.     NAME
  758.         SetMousePosDelta -- moves mousepointer
  759.         
  760.     SYNOPSIS
  761.  
  762.         SetMousePosDelta(DeltaX,DeltaY)
  763.                            D0     D1
  764.         
  765.         SetMousePosDelta(Byte , Byte)    
  766.         
  767.         
  768.     FUNCTION
  769.         moves global mousepointer.
  770.     
  771.         This causes a IDCMP_MOUSEMOVE every time you use this function, so don`t
  772.         forget to wait for your guimessage to keep in sync. 
  773.     INPUTS
  774.  
  775.         DeltaX - ( -127 ... 127 )
  776.         DeltaY - ( -127 ... 127 )
  777.         
  778.     WARNING
  779.  
  780.         This function uses DHA (DirectHardwareAccess). 
  781.         
  782.         Works fine with AGA & CGX
  783.  
  784.     RESULT
  785.         NONE
  786.  
  787.     BUGS 
  788.         NONE
  789.         
  790.     SEE ALSO
  791. dragndrop.library/DND_OpenDragWB                   dragndrop.library/DND_OpenDragWB
  792.  
  793.     NAME
  794.         DND_OpenDragWB -- Opens a dragicon on the Workbench
  795.  
  796.     SYNOPSIS
  797.         Drag = DND_OpenDragWB(Rastport,TA_Result,Window)
  798.          d0                    a0       a1       a2
  799.             
  800.         Long = DND_OpenDragWB(Struct Rastport,struct TA_Result,struct window)
  801.  
  802.     FUNCTION
  803.         This function opens a dragicon the Workbench. It copies the graphic
  804.         from your rastport to the dragicon. You must use the TA_Resultstructure
  805.         to tell the function which region you want as a dragicon. 
  806.  
  807.     WARNING 
  808.  
  809.         In later versions of DND you could offer a own graphic for this
  810.         operation. So DON`T create a TA_RESULT on your own!
  811.  
  812.     INPUTS
  813.  
  814.         Rastport  - rastport where to find the graphics
  815.         TA_RESULT - result of DND_TestArea()
  816.         window    - valid windowstructure where to get the gfx data!
  817.  
  818.     RESULT
  819.         Drag - Dragstructure ( no usefull data for you )
  820.  
  821.     BUGS 
  822.         NONE
  823.         
  824.     SEE ALSO
  825.         DND_CloseDrag(), DND_MoveDrag(), DND_Openpolygon(), DND_OpenDrag()
  826. dragndrop.library/DND_GetDataMsgFromID   dragndrop.library/DND_GetDataMsgFromID
  827.  
  828.     NAME
  829.         DND_GetDataMsgFromID -- gets a message from the queue with parameter
  830.  
  831.     SYNOPSIS
  832.         Drag = DND_GetDataMsgFromID(TaskID,SenderID)
  833.          d0                           d0   d1
  834.             
  835.         Long = DND_GetDataMsgFromID(struct Task,Struct SenderID)
  836.  
  837.     FUNCTION
  838.         This function gets a datastructure from datamessagepipe send by 
  839.         SenderID. This is usefull if you wanna have only messages from one
  840.         Task i.e. if you have send a message and wait for the reply and 
  841.         you won`t get distrubed by other messages ( maybe you won`t handle them there )
  842.  
  843.  
  844.     INPUTS
  845.         Task     - see DND_Get()/INPUTS
  846.         SenderID - ID from the tasks which you expect who send you a message
  847.  
  848.     RESULT
  849.         ok - returns -1 for failure or a DataStructure
  850.  
  851.     BUGS 
  852.         NONE
  853.         
  854.     SEE ALSO
  855.         DND_GetData(), DND_GetDataMsg(), DND_CheckforDataMsg(), 
  856.         DND_CheckforDataMsgFromID(), DND_GetDataMsgFromID()
  857.  
  858.  
  859. dragndrop.library/DND_GetDataMsg               dragndrop.library/DND_GetDataMsg
  860.  
  861.     NAME
  862.         DND_GetDataMsg -- gets a message from queue with parameter
  863.  
  864.     SYNOPSIS
  865.         Drag = DND_GetDataMsg(TaskID,SenderID,Data)
  866.          d0                   d0     d1       d2
  867.             
  868.         Long = DND_GetDataMsg(struct Task,Struct SenderID,long Data)
  869.  
  870.     FUNCTION
  871.         This function gets a datastructure from datamessagepipe send by 
  872.         SenderID if data is equal to given Data. 
  873.     
  874.         This is usefull if you expect a Reply Message from another task 
  875.         and want to remove it.
  876.  
  877.     INPUTS
  878.         Task     - see DND_Get()/INPUTS
  879.         SenderID - ID from the tasks which you expect who send you a message
  880.         Data     - Data or Pointer to Datafield, but that will not be easy :-))
  881.  
  882.     RESULT
  883.         ok - returns -1 for failure or a DataStructure
  884.  
  885.     BUGS 
  886.         NONE
  887.         
  888.     SEE ALSO
  889.         DND_GetData(), DND_GetDataMsg(), DND_CheckforDataMsg(), 
  890.         DND_CheckforDataMsgFromID(), DND_GetDataMsgFromID()
  891.  
  892. dragndrop.library/DND_CheckForDataMsgFromID
  893.  
  894.     NAME
  895.         DND_CheckForDataMsgFromID -- Checks if a msg from ID is on the queue 
  896.  
  897.     SYNOPSIS
  898.         Drag = DND_CheckforDataMsgFromID(TaskID,SenderID)
  899.          d0                                d0    d1
  900.             
  901.         Long = DND_CheckForDataMsgFromID(struct Task,Struct SenderID)
  902.  
  903.     FUNCTION
  904.         This function tests if a messages from SenderID is available on the 
  905.         messagepipe. 
  906.  
  907.     INPUTS
  908.         Task     - see DND_Get()/INPUTS
  909.         SenderID - ID from the tasks which you expect who send you a message
  910.  
  911.     RESULT
  912.         ok - returns -1 for failure or a DataStructure
  913.  
  914.     BUGS 
  915.         NONE
  916.         
  917.     SEE ALSO
  918.         DND_GetData(), DND_GetDataMsg(), DND_CheckforDataMsg(), 
  919.         DND_CheckforDataMsgFromID(), DND_GetDataMsgFromID()
  920.  
  921.  
  922. dragndrop.library/DND_CheckForDataMsg     dragndrop.library/DND_CheckForDataMsg
  923.  
  924.     NAME
  925.         DND_GetDataMsg -- checks for a message on the queue with parameter
  926.  
  927.     SYNOPSIS
  928.         Drag = DND_CheckForDataMsg(TaskID,SenderID,Data)
  929.          d0                        d0     d1       d2
  930.             
  931.         Long = DND_CheckForDataMsg(struct Task,Struct SenderID,long Data)
  932.  
  933.     FUNCTION
  934.         This function tests if a messages from SenderID is available on the 
  935.         messagepipe that contains the given DATA. 
  936.  
  937.         i.e. you can use this for PING-PONG messages 
  938.  
  939.     INPUTS
  940.         Task     - see DND_Get()/INPUTS
  941.         SenderID - ID from the tasks which you expect who send you a message
  942.         Data     - Data or Pointer to Datafield, but that will not be easy :-))
  943.  
  944.     RESULT
  945.         ok - returns -1 for failure or a DataStructure
  946.  
  947.     BUGS 
  948.         NONE
  949.         
  950.     SEE ALSO
  951.         DND_GetData(), DND_GetDataMsg(), DND_CheckforDataMsg(), 
  952.         DND_CheckforDataMsgFromID(), DND_GetDataMsgFromID()
  953.  
  954.